OLA 文档中心

主题

2026-06-18

计算文件SHA哈希值 - SHAFile ​

函数简介 ​

计算指定文件的SHA系列哈希值。

接口名称 ​

SHAFile

DLL调用 ​

c
long SHAFile(long instance, string filePath, int shaType);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
filePath字符串要计算SHA哈希值的文件路径。
shaType整数型哈希类型：0-MD5；1-SHA1；2-SHA256；3-SHA384；4-SHA512；5-SHA3-256；6-SHA3-384；7-SHA3-512。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
string hash = ola.SHAFile("data/readme.txt", 2);
csharp
using OLAPlug;

var ola = new OLAPlugServer();
string hash = ola.SHAFile("data/readme.txt", 2);
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
hash = ola.SHAFile("data/readme.txt", 2)
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
String hash = ola.SHAFile("data/readme.txt", 2);
cpp
var ola = com("OlaPlug.OlaSoft")
var hash = ola.SHAFile("data/readme.txt", 2)
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
hash = ola.SHAFile("data/readme.txt", 2)
text
.局部变量 ola, OLAPlug
ola.创建 ()
hash ＝ ola.SHAFile("data/readme.txt", 2)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var hash = ola.SHAFile("data/readme.txt", 2);
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
文本型 hash = ola.SHAFile("data/readme.txt", 2)
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
std::string hash = ola.SHAFile("data/readme.txt", 2);

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long ptr = SHAFile(instance, "data/readme.txt", 2);
if (ptr != 0) {
    char buffer[4096] = {0};
    GetStringFromPtr(ptr, buffer, sizeof(buffer));
    FreeStringPtr(ptr);
}
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringFromPtr(long ptr, StringBuilder lpString, int size);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int FreeStringPtr(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringSize(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long SHAFile(long ola, string filePath, int shaType);

long instance = CreateCOLAPlugInterFace();
long ptr = SHAFile(instance, "data/readme.txt", 2);
if (ptr != 0) {
    StringBuilder sb = new StringBuilder(GetStringSize(ptr) + 1);
    GetStringFromPtr(ptr, sb, sb.Capacity);
    FreeStringPtr(ptr);
    string hash = sb.ToString();
}
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ptr = ola.SHAFile(instance, b"data/readme.txt", 2)

返回值 ​

返回值说明
非 0成功，返回 哈希值的字符串指针。
0失败。

注意事项 ​

项目说明
路径文件路径必须是有效的文件路径。